home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-1.iso / CDROM / Contents / Naming Convention < prev    next >
Encoding:
Text File  |  1996-10-10  |  3.1 KB  |  83 lines
  1.                    The files on Peanuts
  2.                      =========================
  3.  
  4. The files are compressed with GNU-zip (*.gz) and tarred with GNU-tar
  5. or with normal unix tar (*.tar). You may want to get and install
  6. GNU-zip first. A precompiled and ready-to-run version of GNU-zip is in
  7. Unix/archiver/gzip.1.2.3.NI.b.tar
  8.  
  9. For almost every program package, a description file called
  10. [NameOfPackage].README or [NameOfPackage].[versionNumber].README
  11. exist. The binaries in the archive are available for different
  12. architectures. NeXTStep is available on 68k processors ('black
  13. hardware'), on Intel 486 and Intel pentium processors ('white
  14. hardware'), on HP/PA and on SUN SPARC architecture. 
  15.  
  16. The file names follow the convention:
  17.  
  18. NameOfPackage.[version].[architecture].[distribution].[archivers]
  19.  
  20.  version:       the release and/or version number of the program
  21.  architecture:  if the archive contains binaries, for which architecture?
  22.  distribution:  what does the archive contain? source, binary, both?
  23.  archivers:     file-extensions of the archive program(s)
  24.  
  25. version
  26. =======
  27. The version number can have different formats. Usually it consists of 
  28. the release and the version number (e.g. 1.04). Release numbers with 0 
  29. are normally beta releases (e.g. 0.13) Some packages also use a 
  30. version number like 920904 or 20.Feb.1993 indicating the date of their 
  31. release. If there is no version number mentioned, it is the first and 
  32. only release so far.
  33.  
  34. architecture
  35. ============
  36. The architecture of the binary is a combination of currently up to 4 
  37. letters in a fixed order (NIHS):
  38.  
  39.     N    NeXT m68k ('black hardware')
  40.     I    Intel 486 and Intel Pentium processor ('white Hardware')
  41.     H    HP/PA architecture from HP ('green hardware')
  42.     S    SPARC architecture from SUN ('yellow hardware')
  43.  
  44. The binary is a Multi-Architecture-binary (MAB) or FAT-binary, if it 
  45. contains code, running on two or more architectures.
  46.  
  47. distribution
  48. ============
  49. The contents of the archive. A combination of up to 4 letters, also in 
  50. fixed order (bsda):
  51.  
  52.     b    binaries for the architectures mentioned under 'architecture'
  53.     s    sources included. The sources may (!) compile on every platform
  54.     d    data file: non-executable binary, source or any other file
  55.     a    library included. The library is for the specified architecture
  56.         
  57. The 'd' and 'a' are informal. They are normally only included, when 
  58. there are additional files (libraries, sound etc.) beside the binaries 
  59. or sources in the archive.
  60.  
  61. archivers 
  62. =========
  63. The extension specifying the programs utilized for archiving and 
  64. compressing of the files. 
  65.  
  66.     tar         GNU-tar or normal unix tar
  67.     gz          GNU-zip
  68.     Z           normal unix compress
  69.     compressed  archived and compressed using the NeXT workspace
  70.         
  71. NOTE: 'Z' and 'compressed' are not supported on this archive! The 
  72. usual case therefore is '*.tar', '*.gz' or '*.tar.gz'. However these
  73. extensions may occur in the NeXTanswers directory which is a mirror
  74. of the FTP archive by NeXT.
  75.  
  76. Examples:
  77. =========
  78.  
  79.     tarZan.1.0.N.bs.tar.gz
  80.     Columns.2.97.N.b.tar.gz
  81.     DrivePerformance.1.1.NI.b.tar.Z
  82.  
  83.